Fetch Virtual Account by ID

Get details of your created virtual account by its ID

GET https://api.spotflow.co/api/v1/virtual-account/:id

Headers

authorization String	Bearer SECRET_KEY Include your secret key in the request header as a Bearer token for authorization. Unauthorized requests will result in a 401 HTTP status code.

Path Parameters

id int32

This is the unique ID generated upon creation of your virtual account in either NGN or GHS.

Sample Response in NGN:

200 OK

{
    "id": "9e164443-d10c-4dda-952b-a1a76af37057",
    "accountNumber": "6474247770",
    "accountName": "SPOTFLOW/Jenny Hemsworth",
    "bankName": "Nombank MFB",
    "mode": "live",
    "createdAt": "2025-07-02T15:02:33.605434Z",
    "updatedAt": "2025-07-02T15:06:17.999528Z",
    "lifecycle": "temporary"
}

Sample Response in GHS:

200 OK

{
    "id": "a3652e3d-4a3c-4620-bc2b-22d5b19e7f4e",
    "accountNumber": "7003000100286",
    "accountName": "Jenny Hemsworth",
    "bankName": "Affinity",
    "mode": "live",
    "createdAt": "2025-08-07T13:25:16.008229Z",
    "updatedAt": "2025-08-07T13:25:26.442561Z",
    "lifecycle": "temporary",
    "expiresAt": "2025-08-07T13:25:26.405854300Z"
}